Previously, consumers had to wrap their app with <FlavorProvider> AND
import the CSS for any component to render styled. Forgetting either
produced silently unstyled output — a sharp edge inconsistent with most
component libraries (MUI/Chakra render with a default theme, no Provider
required). The published package now leads with "import CSS and you are
done", and <FlavorProvider> is reserved for explicit flavor switching or
nested-region theming.

- scripts/build-flavor-css.mjs: for pepper, additionally emit an
  unprefixed pass and prepend it to the top of dist/css/all.css.
  Specificity of `[data-flavor="xxx"] .foo` (0,0,3,0) beats `.foo`
  (0,0,2,0), so any FlavorProvider still overrides the baseline. The
  per-flavor dist/css/{flavor}.css files are intentionally unchanged —
  that optimization path still requires matching FlavorProvider flavor
  because the single-flavor file has no other context.
- README.md: reframe the usage section so the minimal "just import CSS"
  example comes first, and FlavorProvider is shown only in the
  override/nesting example. Document the existing source-order caveat
  for nested providers (outer lolipop + inner pepper will resolve to
  lolipop because CSS descendant selectors match any ancestor and
  the later flavor wins on tie).
- FlavorProvider JSDoc: note that pepper now applies by default via CSS
  baseline, so the Provider is only needed for explicit flavor choices.

Size: all.css 2.93 MB -> 3.29 MB (~+19 KB gzip) due to the added
unscoped pepper pass.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Signal "this is the default stylesheet you should import" via naming +
path placement. `all.css` reads like "one of seven", while the new path
`wip-ui/styles.css` matches the convention consumers already know from
Mantine (`@mantine/core/styles.css`) and Radix Themes
(`@radix-ui/themes/styles.css`).

- scripts/build-flavor-css.mjs: emit dist/styles.css (package root)
  instead of dist/css/all.css. Per-flavor dist/css/{flavor}.css files
  are unchanged. Also clean DIST_DIR and stale dist/styles.css before
  writing, so renames/removals don't leave orphaned files in dist/.
- package.json: expose "./styles.css" subpath export. Per-flavor
  "./css/*.css" pattern retained for the bundle-size-optimization path.
- README.md + FlavorProvider JSDoc: reference wip-ui/styles.css.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>